Manage the Virtual IQ

ExtremeCloud IQ administrators with read and write permission can perform the following administrative tasks:

  • Manually back up and restore Virtual IQ (VIQ) account data.
  • Delete data to reset the Virtual IQ database.
  • Export and import Virtual IQ data.
  • Enable the CoPilot feature for the VIQ
  • Enable and disable SSH (see Enable SSH Availability)
  • Enable and disable the supplemental CLI tool.
  • Enable and disable the verification of APs using the out-of-the-box wireless onboarding feature.

Use this task to manage the VIQ.

  1. Mouse over Account, and then select Global Settings.
  2. From the Global Settings menu, select VIQ Management.
  3. To perform a manual backup, select Backup Now.

    To ensure data integrity, ExtremeCloud IQ suspends activity in the Virtual IQ during both the backup and the restore process. The Current Status changes from ACTIVE to SUSPENDING during these processes. When a backup is complete, ExtremeCloud IQ displays the backup event in the Backup History table at the bottom of the page.

  4. To restore a backup, choose a Backup File from the Backup History table, then select Restore.
    Note

    Note

    You must restore the Virtual IQ in the same version of ExtremeCloud IQ from which you performed the backup. If the versions are different, a compatibility error message (Version Mismatch) is displayed.

  5. Select Reset VIQ to delete the Virtual IQ database.

    This resets it to its initial state before any inventory or configurations were added.

  6. To export Virtual IQ data:
    1. Select Export Virtual IQ and follow the instructions in the dialog boxes.

      ExtremeCloud IQ suspends the Virtual IQ during the export operation and displays a progress report showing its status. When it is complete, a message displays stating that the Virtual IQ was successfully exported. A link to the exported .tar.gz file is displayed to the right of the Export Virtual IQ button.

    2. Select the link to download and save the .tar.gz file to a local directory on your management system.

      The tarball contains numerous files for different areas of the Virtual IQ, such as certificate files in PEM format, captive web portal files in HTML, JavaScript, and graphic image file formats, background image files for topology maps, and configuration objects and Virtual IQ settings in XML format.

      Note

      Note

      Global Settings > VIQ Management > Download is not available for trial VIQs.
  7. To import Virtual IQ data:
    1. Select Import Virtual IQ.
    2. Select either Import Virtual IQ from ExtremeCloud IQ or Import Virtual IQ from HM Classic, depending on the source of the data.
    3. Either drag the .tar.gz file into the first field at the top or select Choose to navigate to the location of the file and select it.
    4. Select Import Now.

      Optionally, you can change the import timeout, which is 30 minutes by default, and the action to take if an error occurs; abort (default) or continue.

  8. Slide the Enable CoPilot feature for this VIQ toggle to ON to enable it.

    The CoPilot feature requires a ExtremeCloud IQ CoPilot license. If CoPilot is disabled for this VIQ, the CoPilot features are not available, and the administrator does not receive ML/AI-driven insights and proactive follow-ups.

  9. Slide the SSH Availability toggle to ON to enable it.
    Note

    Note

    Enabling SSH availability potentially gives others direct access to your devices during the time that SSH access is available. While active, SSH Availability exposes your device to the public Internet through an SSH proxy, protected only by the device administrator credentials, because SSH FTP assumes that it is running over a secure channel. For more information, see Enable SSH Availability.

  10. Slide the Supplemental CLI toggle to ON to enable it.

    Use the Supplemental CLI tool to append CLI commands to a network policy when you upload the configuration to managed devices. You can access this feature in multiple places in the GUI, after you enable it for the Virtual IQ.

  11. To enable the Virtual IQ to permit APs to respond to mesh-join requests, slide the AP Out-of-the-box Wireless Onboarding toggle to ON.

    This setting permits or prohibits AP responses to mesh-join requests. When this setting is off, the Virtual IQ prohibits managed APs from responding even if the serial number of the requesting AP is listed in the Virtual IQ.

9038986-00 Rev AA